home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / timex.z / timex
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIMMMMEEEEXXXX((((1111))))                                                              TTTTIIIIMMMMEEEEXXXX((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      timex - time a command; report process data and system activity
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ttttiiiimmmmeeeexxxx  [options] command
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The given _c_o_m_m_a_n_d is executed; the elapsed time, user time and system
  16.      time spent in execution are reported in seconds.  Optionally, process
  17.      accounting data for the _c_o_m_m_a_n_d and all its children can be listed or
  18.      summarized, and total system activity during the execution interval can
  19.      be reported.
  20.  
  21.      The output of _t_i_m_e_x is written on standard error.
  22.  
  23.      _O_p_t_i_o_n_s are:
  24.  
  25.      ----pppp  List process accounting records for _c_o_m_m_a_n_d and all its children.
  26.          Suboptions ffff,,,, hhhh,,,, kkkk,,,, mmmm,,,, rrrr,,,, and tttt modify the data items reported.  The
  27.          options are as follows:
  28.  
  29.                ----ffff    Print the _f_o_r_k/_e_x_e_c flag and system exit status columns
  30.                      in the output.
  31.  
  32.                ----hhhh    Instead of mean memory size, show the fraction of total
  33.                      available CPU time consumed by the process during its
  34.                      execution.  This ``hog factor'' is computed as:
  35.                          (total CPU time)/(elapsed time)
  36.  
  37.                ----kkkk    Instead of memory size, show total kcore-minutes.
  38.  
  39.                ----mmmm    Show mean core size (the default).
  40.  
  41.                ----rrrr    Show CPU factor (user_time/(system_time + user_time)).
  42.  
  43.                ----tttt    Show separate system and user CPU times.  The number of
  44.                      blocks read or written and the number of characters
  45.                      transferred are always reported.
  46.  
  47.      ----oooo  Report the total number of blocks read or written and total
  48.          characters transferred by _c_o_m_m_a_n_d and all its children.
  49.  
  50.      ----ssss  Report total system activity (not just that due to _c_o_m_m_a_n_d) that
  51.          occurred during the execution interval of _c_o_m_m_a_n_d.  All the data
  52.          items listed in _s_a_r(1) are reported.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      sar(1).
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIMMMMEEEEXXXX((((1111))))                                                              TTTTIIIIMMMMEEEEXXXX((((1111))))
  71.  
  72.  
  73.  
  74. WARNING
  75.      Process records associated with _c_o_m_m_a_n_d are selected from the accounting
  76.      file ////vvvvaaaarrrr////aaaaddddmmmm////ppppaaaacccccccctttt by inference, since process genealogy is not
  77.      available.  Background processes having the same user-id, terminal-id,
  78.      and execution time window will be spuriously included.
  79.  
  80. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  81.      A simple example:
  82.  
  83.           timex -ops sleep 60
  84.  
  85.      A terminal session of arbitrary complexity can be measured by timing a
  86.      sub-shell:
  87.  
  88.           timex -opskmt sh
  89.  
  90.                session commands
  91.           EOT
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.